home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / play / edplyr21.lha / EdPlayer.DOCs / EdP.history.README next >
Text File  |  1992-09-19  |  14KB  |  263 lines
  1. ----------------------------------------------------------------------------
  2. A History of changes to EdPlayer.  All previous users, PLEASE read this
  3. file to see what's new!!
  4. ----------------------------------------------------------------------------
  5. EdPlayer v2.1:  9/20/92
  6.  
  7.     Ah, yes, time to fix the bugs.
  8.  
  9. * New display mode for EdSynth:  HIRES/INTERLACE!  The EdSynth popup
  10.   button now cycles through No EdSynth, Old EdSynth, and New EdSynth.
  11. * asl.library now supported.  See docs for FREQ command.
  12. * NOTE SKIPPING BUG -- DIE DIE DIE DIE!!!!!!!!!
  13.   With 2.0, I thought that I had killed this note-skipping bug.  But it
  14.   seems that every system is different:  What is fixed on my A3000 might
  15.   still be broken on yours.  SO, I made a new command, "DMAWait <value>",
  16.   that lets you adjust it yourself, for best results!!  A new query,
  17.   "ADMA", reads the current value of DMAWait.  See the DOCs or startup file
  18.   for info on how to use this new command.
  19. * ProTracker tempo commands fixed.  A patch in the PT replay code, designed
  20.   to make EdPlayer compatible with old NT mods, actually broke compatability
  21.   with newer PT mods.  A small modification to the patch should fix it
  22.   for both the old and the new.
  23. * EdPlayer interrupt priority lowered to "software interrupt".  This means
  24.   that more time-critical interrupts like modem activity will be able
  25.   to interrupt EdPlayer.  Modem operations should return to normal.
  26. * Now takes less CHIP memory.  The EdSynth code used to take about 50k
  27.   more CHIP mem than it needed to.  EdPlayer was streamlined so much
  28.   in this area that it actually got smaller this version (actually, I
  29.   think EdP 2.0 might have had a smaller executable than EdP 1.1, but
  30.   that was only because I started compressing the executable in 2.0).
  31. * New ARexx queries, AVERsion, AERRor and APLAying.  See docs.
  32. * New companion program created, "EdPlayerJr".  EdPlayer Junior is
  33.   just EdPlayer without the mouse interface (main panel/EdSynth).
  34.   Even after opening the iconified window, it only takes about 40 bytes
  35.   (yes, BYTES!!) of CHIP mem.  It can be controlled through telled/
  36.   cteled/ARexx, the same as the "big" version of EdPlayer in every
  37.   respect except the MENU command.  This small-size, low-mem player
  38.   is perfect for playing back songs or programs created earlier with the
  39.   main EdPlayer under low mem conditions, or for putting ARexx-controlled
  40.   music in presentations (that don't need the main panel), etc.
  41.  
  42. ----------------------------------------------------------------------------
  43. WISH LIST:
  44.      Before reporting a suggestion, please make sure it's not in the wish
  45. list.  If it's not, then report it!
  46. The following is a wish list of features that might or might not appear in
  47. a future version of EdPlayer:
  48.  
  49. * I wish EdP could support MED song+samples format $*#&^*!!!
  50. * I wish EdP had a sound effects server.
  51. * I wish EdP supported MED's MOD1 and OctaMed formats.
  52.  
  53. ----------------------------------------------------------------------------
  54. EdPlayer v2.0:  7/17/92
  55.  
  56.     Hmm, I considered calling this EdPlayer 1.2, but then I decided to
  57. call it v2.0.  Why?  Well here's a few reasons:
  58.  
  59. * 100% new music-playing code.  NoiseTracker 1.0 Replay was replaced by
  60.   Protracker 1.1b Replay.  MED 3.10 Replay was replaced by MED 3.21
  61.   Replay.  (ProTracker hacked a bit to support some NT commands, notably
  62.   effect F00 for which EdP does a pattern-break, not a STOP).
  63. * Now compatible with ALL Amigas!  (I hope!)  ProTracker Replay borrows
  64.   a non-cpu specific timer from MED Replay, so it should not skip notes
  65.   on any speed machine.
  66. * Tested on an A3000, A2000, and A500, under both OS1.3 and OS2.0!
  67. * 34 new ARexx commands added since 1.1a!  20 of those are ARexx queries,
  68.   where the ARexx script can ask EdPlayer almost anything about its
  69.   current status and settings.
  70. * New version of kd_freq.library supported.  WATCH OUT!!  This new
  71.   version requires pressing the "select" gadget in the upper-right
  72.   when multi-selecting files.  I don't like this much, but it's
  73.   beyond my control.
  74. * Select favorite file requester (not stuck with default) (see FREQ).
  75. * PLAY command will now pull names from the program if needed.
  76. * Filter Override added, ARexx control of filter added (see FILT).
  77. * FastForward and Rewind buttons added to panel
  78. * Random programs added -- EdPlayer plays songs in an arbitrary order.
  79. * Save programs!  Save in ARexx or CLI form.  (see SAVA or SAVC).
  80. * Documentation split into several files for easier access to needed parts.
  81. * Fade rate control slider added to panel.
  82. * New VU-meters and a Spectrum Analyzer added to panel.
  83. * ARexx STARTUP SCRIPT "rexx:Startup.EdP" added.
  84. * ProgramJump added: jump to specific song # in program (see PJUM).
  85. * SuperJump added: jump INSTANTLY to a position in song (see SJUM, JUMP).
  86. * Most ARexx commands can optionally be longer than 4 letters.
  87.   Ex:  You can say 'pause 5' instead of 'PAUS 5', etc.
  88. * My email address changed to elm4@lehigh.edu.  Oops, that's not a feature.
  89. * ARexx control of LED display mode added (see DISP).
  90. * Extract RGB colors from MED mods and use for panel (see MCOL).
  91. * Programs Telled and Cteled were improved, see their commented sourcecodes.
  92. * NT/PT Mod init routine now has range checking, should now warn users
  93.   when trying to load defective NT/PT mods.
  94. * ARexx can display arbitrary messages in panel scroll bar (see MESG).
  95. * Optional low-priority background loading/decrunching (see LPRI).
  96. * New commands (SWAI, PWAI) that suspend a script until a song or program
  97.   is finished or reach a certain point.
  98. * Text in panel scroll bar not so quick to disappear (used to disappear
  99.   after any gadget or mouse click).
  100. * New display mode, named "EdSynth" by my brother who thinks everything
  101.   I write should have my name on it.  EdSynth displays a piano keyboard
  102.   on the screen and colors notes as they are played.  Fun to watch!
  103.  
  104. Well, what do you think?  Was it worth the number 2.0?
  105. ----------------------------------------------------------------------------
  106. EdPlayer v1.1a: 11/03/91
  107.     Oops!!  Version 1.1 broke EdPlayer's compatability with people using
  108. OS 1.3 with an overscanned screen.  This version fixes that bug.  Also
  109. this version allows the iconified window, which stretches to the left when
  110. printing long filenames in large fonts, to also stretch to the right if
  111. it can't go any further left.
  112. ----------------------------------------------------------------------------
  113. EdPlayer v1.1:  10/25/91
  114.     This is just a minor update to 1.0.  I kinda rushed it out, because
  115. some bugs needed fixing right away.  Also some useful stuff added.
  116. * req.library added.  If EdPlayer can't open kd_freq.library, it will
  117.   look for req.library.  I'm also thinking about the posibility of asl...
  118. * powerpacker.library added.  If you were using PowerPatch for EdPlayer
  119.   alone, you can remove it from your startup-sequence, as I suspect
  120.   EdP will be much more effecient WITHOUT it.  Also you can see neat
  121.   messages like ...LOADING CRUNCHED... and ...DECRUNCHING... if you're
  122.   NOT using the patch.  A new AREXX command, "DCOL", allows setting of
  123.   the decrunch effect.
  124. * New AREXX command "ERAS" allows erasing the program.
  125. * ARexx commands are no longer case-sensitive.  I guess this is kind of
  126.   a frill, but I like it better this way.  NOTE: the "MIDL" command
  127.   still NEEDS a case-sensitive parameter for midi_dest.
  128. * Can load PP encrypted (password protected) modules.  Will bring up a
  129.   password requester when needed.  Also passwords can be entered via
  130.   ARexx, see LOAD and JUKE in the DOCs for an explanation...
  131. * Iconified window now supports bigger fonts
  132. * Iconified window now has NAME of current song!  Also scrollbar has a
  133.   new trick that puts the song name there after a scroll.
  134. * PAL/Overscanned WB screens supported better.  EdPlayer 1.0 used to open
  135.   in the NTSC, no overscan position all the time.  EdP 1.1 tries to
  136.   center itself, and appear flush with the bottom.
  137. * FADE bug fixed.... NOT!!!!  This is NOT a BUG!  PLEASE read the DOCs
  138.   in the BUTTONS section under FADE for a NEW & IMPROVED description
  139.   of why EdPlayer fades the way it does!!  The FADE code didn't change.
  140. * Slight bug in program mode made it impossible to enter songs with
  141.   European characters in the names (like ü, ä, etc.).  This is now
  142.   fixed.  Never do signed arithmetic on ASCII bytes...  >127 looks neg :-)
  143. Hmm, now that I look at it, it doesn't seem like such a "minor" update
  144. after all...  oh well...
  145. ----------------------------------------------------------------------------
  146. EdPlayer 1.0: Sometime in July 1991, I think.
  147.    New features in EdPlayer 1.0:
  148.  
  149. * All of them.
  150.  
  151. Well what did you EXPECT???  duh!
  152. ----------------------------------------------------------------------------
  153.  
  154. Well that ends the useful part of this file.  Only read on if you want
  155. to hear about...
  156.  
  157. ============================================================================
  158.  
  159.                     THE CASE OF THE BACKWARDS AUDIO
  160.  
  161. ============================================================================
  162.  
  163. (2.1 note:  I'm sorry this is the same story as 2.0.  :-(  I didn't have
  164.  time to write a new one).
  165.  
  166. It is a wonderful feeling, to open the box of a brand new A3000. 
  167. Apparently, my MegaBall fans got really addicted.  I'd like to thank them.
  168. Of course, now I have the chance; I can make MegaBall more compatible
  169. with the 3000.  Umm, soon.  Ahem *cough* *hack*  Anyway, when running
  170. some final tests on EdPlayer 2.0 on my new A3000, I ran into one
  171. very mysterious problem.
  172.  
  173. (2.1 note:  MegaBall 2.1 is now available, and is A3000 compatible).
  174.  
  175. The new display mode, that is supposed to separate the VU-meters into
  176. left and right meters, was separating them into right and left meters.
  177. This was rather annoying, to see a drum channel beating on the left
  178. while listening to it on the right.  I had previously tested EdPlayer
  179. on three A2000s and an A500, and the left/right channel separation worked
  180. just fine on all those machines.
  181.  
  182. Silly me, I thought, I must have wired the plugs backwards when connecting
  183. my stereo to the 3000.  I peeked around back and looked at the wiring;
  184. it looked OK.  I pulled out the left plug and tapped on it.  I could hear
  185. clicks on the left speaker.  I tried the same with the right plug and
  186. heard clicks on the right speaker.  So, there was nothing wrong with my
  187. wiring.  I could only assume that some quirk in the 3000's motherboard
  188. was sending the left audio to the plug marked "right," and vice versa.
  189.  
  190. (2.1 note:  or maybe some dweeb put the left/right stickers on backwards).
  191.  
  192. This drove me nuts, because I didn't want to assume there was anything
  193. wrong with my new computer (other than some initial HD troubles which
  194. Briwall promptly fixed for me :-).  After a few days of watching EdPlayer
  195. get it backwards on the 3000, get it right on the 2000 and 500, and
  196. re-checking the wiring on all the machines, I finally gave up and
  197. actually looked at the "Quick Connect" installation guide.  I know
  198. it seems very odd that an experienced Amiga person like myself would
  199. go looking at the "how to hook up your computer even if you have
  200. peanuts for brains" wiring diagrams, but I thought it was needed in
  201. this case.
  202.  
  203. What I found was not much use.  First, I discovered that Commodore had done
  204. a MUCH better job with the 3000's install guide than they did with the
  205. old 2000's.  This was just peachy, but it didn't help me.  Second, I
  206. found that the install guide showed the "LEFT" and "RIGHT" labels in
  207. the same place as on my 3000 (I was secretly hoping they would be
  208. reversed).  And lastly, I found that the guide showed the LEFT plug
  209. colored red, and the RIGHT plug colored white, when on my A3000,
  210. the LEFT was white and the RIGHT was red (a much nicer configuration).
  211.  
  212. This just confirmed my fears that someone had done some weird switching
  213. around of the audio hardware that was probably responsible for
  214. EdPlayer's mixup of the left/right VU-meter display.  But the biggest
  215. suprise was yet to come.
  216.  
  217. A few days ago I got my hands on the new RKMs (programmer's manuals for
  218. Workbench 2.0).  I was looking through them and I happened to see the
  219. entry for the audio.device.  Its "Possible Channel Combinations" chart
  220. (DEVICES, page 23) agreed with my wacky A3000 and disagreed with
  221. both EdPlayer and all the A2000s and A500s I could find.  I quickly
  222. looked up the same chart in the old Workbench 1.3 manuals
  223. (LIBRARIES & DEVICES, page 615) and this is what I found:
  224.  
  225. Workbench 1.3 RKM's:
  226.      Channel 3     Channel 2     Channel 1     Channel 0
  227.        left          right         right         left
  228.  
  229. Workbench 2.0 RKM's:
  230.      Channel 3     Channel 2     Channel 1     Channel 0
  231.        right         left          left          right
  232.  
  233. So there it is, in back and white in the two books, staring me in the face.
  234. This is no mistake in my wiring, or in my new A3000's motherboard.
  235. This is a deliberate and malicious switcharoo on the part of Commodore,
  236. probably perpetrated by the same C= employee who decided it was a good
  237. idea to hook the audio filter to the Amiga's power LED.
  238.  
  239. This has implications farther reaching than minor EdPlayer viewing
  240. annoyances.  Let's suppose you're playing Dungeon Master on your
  241. new A3000 and you hear monster footsteps on the right speaker...
  242. You quickly turn to the right... and no one is there!  Suddenly,
  243. you are attacked from behind!  Now you're dead!!  Hahahaha.
  244. All because some engineer decided to switch around the audio outputs.
  245.  
  246. So, here is my recommendation to ALL Amiga 3000 owners and developers:
  247.                  **** SWITCH YOUR AUDIO PLUGS. ****
  248.  
  249. Plug your A3000's LEFT output into your stereo's RIGHT input, and the
  250. A3000's RIGHT output into the stereo's LEFT input.
  251.  
  252. Maintain compatability!!
  253.  
  254. All programs developed for use under 1.3 will then work properly, and all
  255. programs developed for use under 2.0 should follow the old 1.3 style,
  256. because switching it around improves nothing!  There is really no
  257. excuse for the two operating systems to be incompatible in this area.
  258.  
  259. ----------------------------------------------------------------------------
  260. Well, I hope you enjoyed EdPlayer's story this version.  See ya in
  261. EdPlayer 2.2....
  262.                                            --Ed.
  263.